home *** CD-ROM | disk | FTP | other *** search
/ AMOS PD CD / amospdcd.iso / 601-625 / apd617 / malcolm_lavery / rainbow _writer / read_me < prev   
Text File  |  1986-08-03  |  6KB  |  165 lines
  1. *
  2. *******************************************************
  3. *                     R A I N B O W                    *
  4. *                      W R I T E R                     *
  5. *                      -----------                     *
  6. *                      Version 1.1                     *
  7. *                   By Malcolm Lavery                  *
  8. *                         ©1994                        *
  9. *
  10. *******************************************************
  11.  
  12.  
  13.                     AN INTRODUCTION
  14.                     ***************
  15.  
  16. Welcome to the wonderful world of rainbows,a world so 
  17. colourful that the best pair of shades would have trou
  18. ble dimming.
  19.  
  20. As you will see from the example programs supplied on 
  21. this disk,rainbows can be used for more than colourful 
  22. backgrounds for games,they can be moved,scrolled and an
  23. imated in a number of ways.
  24.  
  25. The main Rainbow Writer program needs no instructions,f
  26. or it is by far the easiest and best rainbow editor to 
  27. use,all functions can be selected with the mouse,by poi
  28. nting and clicking on one of the buttons,or by using the 
  29. keyboard short cut for that button,which are clearly ma
  30. rked along side the button name.
  31.  
  32.  
  33.                     RAINBOW BANKS
  34.                     *************
  35.  
  36. Once you have drawn your rainbow using the Ranibow writ
  37. er program,you can save it,in two ways,
  38.  
  39. 1: As a full screen rainbow,this will save the whole sc
  40. reen as a rainbow,even if all the screen is not used,th
  41. is is good for game backgrounds where only one rainbow 
  42. is needed in the background of the game,full screen rai
  43. nbow banks have the extension ".rnb",at the end of there 
  44. filename.
  45.  
  46. 2: As cut rainbows,these are small sections of rainbows 
  47. that you have cut from the screen,into the buffer,and 
  48. then saved to disk as a rainbow cut,rainbow cuts have 
  49. the extension ".buf",at the end of the filename.
  50.  
  51. Once saved to disk, either as a ".rnb" or ".buf" rainbow 
  52. bank,they will both be loaded and displayed in Amos the 
  53. same way.
  54. The only difference between the two types of rainbow ba
  55. nks once loaded into Amos/Amos Pro,is their size.
  56.  
  57. You can load the rainbow banks into you amos program wh
  58. en you require them,or you can load and then save the 
  59. rainbow banks along with your program.
  60.  
  61.  
  62.         HOW TO LOAD AND DISPLAY A RAINBOW BANK
  63.         **************************************
  64.  
  65.  
  66. You can display your full or cut rainbow bank using the 
  67. procedures on this disk,they are:
  68.  
  69.           _RAINBOW[Number,Bank,Ypos,Effected]
  70.           ***********************************            
  71.                  
  72.            Number=rainbow number (0 to 3)
  73.            Bank=Source rainbow bank to display
  74.                  Ypos=Start Y screen coordinate
  75.             Effected=screen colour effected by rainbow    
  76.             
  77. This procedure simply displays a new rainbow onto the 
  78. screen from a rainbow bank starting from the Ypos,and 
  79. effecting(showing through) a chosen screen colour.
  80.  
  81.              _UPDATE_RAINBOW[Number,Bank]          
  82.              ****************************
  83.  
  84.       Number=Already displayed rainbow to update
  85.       Bank=Source bank of new rainbow
  86.  
  87. This procedure allows you to update the contents of a 
  88. already displayed rainbow.
  89.  
  90.            _MERGE_RAINBOW[Number,Bank,Ypos]
  91.            ********************************
  92.  
  93. Number=Number of a already displayed rainbow to merge to
  94. Bank=Source bank of rainbow to merge
  95. Ypos=Y coordinate of merged rainbow
  96.  
  97. This procedure allows you to merge as many rainbows as 
  98. you like into a already displayed rainbow.
  99.  
  100.              _MOVE_RAINBOW[Number,Ypos]
  101.              **************************
  102.  
  103. Number=Number of a already displayed rainbow to move
  104. Ypos=New Y coordinate
  105.  
  106. This procedure is used to move a already displayed rain
  107. bow to a new Y coordinate.
  108.  
  109.  
  110.                     OTHER COMMANDS    
  111.                     **************
  112.  
  113. You are not limited to these procedures,these were wrote 
  114. by my to make displaying the rainbow banks as simple as 
  115. possible,once a rainbow bank is loaded and displayed on
  116. to the screen,it can be treated in just the same way as 
  117. a normal rainbow,in fact once displayed,it is a normal 
  118. rainbow,and as such,it can me moved,changed,animated etc 
  119. with any of the normal Amos rainbow commands.
  120.  
  121.  
  122.               FOR MORE EXPERIENCED AMOSERS.   
  123.               -----------------------------   
  124.              THE BANK FORMAT IS AS FOLLOWS.  
  125.              ------------------------------  
  126.  
  127. Header   
  128.  
  129. dc.l Address of next bank    Start-24  
  130. dc.l Length of bank+16       Start-20  
  131. dc.l Number of bank          Start-16
  132. dc.w Flag                    Start-12 (3=Chip Data or    
  133.                                          1=Fast Data) 
  134. dc.w Free for future use     Start-10 (Do not use!)
  135. dc.b "Rainbows"              Start-8 (Name of bank *8    
  136.                                                bytes) 
  137.  
  138. Start                        Returned by START function
  139.  
  140.    REPT Number of scanlines in rainbow                 
  141.                   
  142. dc.w colour            decimal value of rainbow scanline
  143.  
  144.    ENDR                                 
  145.  
  146.  
  147. If you like this program and feel a overwhelming urge to 
  148. give me something for it,or just want to get in contact 
  149. with me,then write to me at the following address...
  150.  
  151.                    MALCOLM LAVERY
  152.                    20 SHAKESPEARE AVENUE
  153.                    ORGILL
  154.                    EGREMONT
  155.                    CUMBRIA 
  156.                    CA22 2HF
  157.                    ENGLAND  
  158.  
  159.  
  160. THIS PROGRAM IS PUBLIC DOMAIN,but if you do spread or 
  161. copy it then please copy all the associated files and 
  162. text files with it,and please do not change them!!!.
  163.  
  164.                   Thanks (Mal)...
  165.